home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / pmtime.z / pmtime
Encoding:
Text File  |  2002-10-03  |  4.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMTTTTIIIIMMMMEEEE((((1111))))                                                            PPPPMMMMTTTTIIIIMMMMEEEE((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmttttiiiimmmmeeee - Performance Co-Pilot time control server
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      $$$$PPPPCCCCPPPP____BBBBIIIINNNNAAAADDDDMMMM____DDDDIIIIRRRR////ppppmmmmttttiiiimmmmeeee [----aaaa] [----hhhh] ----pppp _p_o_r_t_n_a_m_e
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ppppmmmmttttiiiimmmmeeee provides a graphical user interface for PCP applications requiring
  16.      time control.  ppppmmmmttttiiiimmmmeeee is not normally invoked directly by users.  Rather,
  17.      it is run by calling the Performance Metrics Application Programming
  18.      Interface (PMAPI) function ppppmmmmTTTTiiiimmmmeeeeCCCCoooonnnnnnnneeeecccctttt(3).
  19.  
  20.      The ----pppp argument is required.  When ppppmmmmttttiiiimmmmeeee starts, it creates _p_o_r_t_n_a_m_e in
  21.      the file system.  This is a Unix domain socket serving as the control
  22.      port that ppppmmmmttttiiiimmmmeeee will accept new connections on.
  23.  
  24.      When starting, ppppmmmmttttiiiimmmmeeee creates and initializes a ViewKit dialog containing
  25.      controls that are suitable for live/real-time time control (if the ----hhhh
  26.      flag is given) or for archive replay (if the ----aaaa flag is given).  If
  27.      neither ----hhhh or ----aaaa are given, the default is ----hhhh.  The dialog will be
  28.      initially managed (visible) only if the client requested it, as described
  29.      in ppppmmmmTTTTiiiimmmmeeeeCCCCoooonnnnnnnneeeecccctttt(3).
  30.  
  31.      ppppmmmmttttiiiimmmmeeee will then enter its main loop, accepting new connections and
  32.      sending time control IPC messages to its client(s).  These messages are
  33.      described in detail in ppppmmmmttttiiiimmmmeeee(3).
  34.  
  35.      When the number of connected clients reaches zero, ppppmmmmttttiiiimmmmeeee will remove the
  36.      control socket and exit.  Clients disconnect either by calling
  37.      ppppmmmmTTTTiiiimmmmeeeeDDDDiiiissssccccoooonnnnnnnneeeecccctttt(3) or simply exiting (implicitly closing the socket
  38.      connection).
  39.  
  40.      The arguments to ppppmmmmttttiiiimmmmeeee are as follows:
  41.  
  42.      ----aaaa   Use archive mode.  This instructs ppppmmmmttttiiiimmmmeeee to create a dialog with
  43.           time controls suitable for manipulating the archive position,
  44.           allowing full VCR control.  This argument is mutually exclusive with
  45.           ----hhhh.
  46.  
  47.      ----hhhh   Use live (host) mode.  This instructs ppppmmmmttttiiiimmmmeeee to create a dialog with
  48.           time controls suitable for live/real-time monitoring.  This argument
  49.           is mutually exclusive with ----aaaa.
  50.  
  51.      ----pppp   Specifies the path to the control port, as described above.  If
  52.           _p_o_r_t_n_a_m_e already exists, ppppmmmmttttiiiimmmmeeee will display an error message and
  53.           exit.  When ppppmmmmttttiiiimmmmeeee exits, it removes _p_o_r_t_n_a_m_e.
  54.  
  55. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  56.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  57.      file and directory names used by PCP.  On each installation, the file
  58.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  59.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMTTTTIIIIMMMMEEEE((((1111))))                                                            PPPPMMMMTTTTIIIIMMMMEEEE((((1111))))
  71.  
  72.  
  73.  
  74.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  75.  
  76. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  77.      PPPPMMMMAAAAPPPPIIII(3) and ppppmmmmttttiiiimmmmeeee(3).
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.